FireMon API

Overview

An application programming interface (API) is a set of rules, protocols, and tools that allows different software applications to communicate and interact. APIs define the methods and data formats used for communication between software components, enabling them to exchange information and perform specific tasks.

APIs are comprised of numerous endpoint calls. An endpoint is a specific element within SIP, such as a domain ID, and a call is a set task that is performed on the endpoint. API calls can add, modify, delete, or simply retrieve user data in a software application. The list below defines API endpoint call headers.

  • GET - retrieves specified information on specific element
  • PUT - updates a specified element
  • POST - send data to an API, either creating or updating an element
  • DELETE - deletes specified element

"Element" is a general term used to refer to a specific component, feature, or entity within an API. It represents a distinct part or aspect of the API that provides a particular functionality or serves a specific purpose.

How API calls can be used for SIP modules

The FireMon Swagger API calls are dynamically generated for each SIP module - Security Manager, Policy Planner, and Policy Optimizer - from their respective swagger.json pages.

FireMon API calls can be executed in several different ways:

  • Using the browser*

  • Using cURL

  • Using Postman

Each task that you can execute in SIP has a corresponding API endpoint to match it. For example, in the Administration module , you can manually delete a data collector. But you can also use the DELETE/collector/{id} endpoint to delete a specific data collector by its ID.

Accessing API endpoints through an API client such as Postman, a developer can use the API to integrate SIP into existing software platforms and customize SIP functionality. For example, you could use the API to build a tool to create custom reports.

The preferred method is using the browser -- accessing the Swagger UI from within the SIP Administration module.